ACS x-header Format Configuration Mode Commands


ACS x-header Format Configuration Mode Commands
 
 
The ACS x-header Format Configuration Mode is used to create and configure extension-header (x-header) formats.
note_smallImportant: This feature is license dependent. Please contact your local sales representative for more information.
 
note_smallImportant: The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).
 
end
Exits the current configuration mode and returns to the Exec mode.
Product
All
Privilege
Security Administrator, Administrator
Syntax
end
Usage
Use this command to return to the Exec mode.
 
exit
Exits the current mode and returns to the parent configuration mode.
Product
All
Privilege
Security Administrator, Administrator
Syntax
exit
Usage
Use this command to return to the parent configuration mode.
 
insert
This command configures the x-header fields to be inserted in HTTP/WSP GET and POST request packets.
note_smallImportant: This command is license dependent. Please contact your local sales representative for more information.
Product
ACS
Privilege
Security Administrator, Administrator
Syntax
In StarOS 8.0:
insert xheader_field_name { string-constant xheader_field_value | variable { bearer { 3gpp charging-id | ggsn-address | imsi | radius-calling-station-id | sgsn-address | sn-rulebase | subscriber-ip-address } | http { host | url } }
no insert xheader_field_name
In StarOS 8.1, StarOS 9.0, and later releases:
insert xheader_field_name { string-constant xheader_field_value | variable { bearer { 3gpp { apn | charging-characteristics | charging-id | imei | imsi | qos | rat-type | s-mcc-mnc | sgsn-address } | acr | customer-id | ggsn-address | mdn | msisdn-no-cc | radius-calling-station-id | session-id | sn-rulebase | subscriber-ip-address | username } [ encrypt ] | http { host | url } }
no insert xheader_field_name
no
Removes the specified x-header field configuration.
xheader_field_name
Specifies the x-header field name to be inserted in the packets.
xheader_field_name must be an alpha and/or numeric string of 1 through 31 characters in length.
Up to 10 fields can be inserted in each x-header format.
string-constant xheader_field_value
Specifies constant string value for x-header field to be inserted in the packets.
xheader_field_value must be the x-header field value, and must be an alpha and/or numeric string of 1 through 63 characters in length.
variable
Specifies name of the x-header field whose value must be inserted in the packets.
bearer { 3gpp { apn | charging-characteristics | charging-id | imei | imsi | qos | rat-type | s-mcc-mnc | sgsn-address } | acr | customer-id | ggsn-address | mdn | msisdn-no-cc | radius-calling-station-id | session-id | sn-rulebase | subscriber-ip-address | username } [ encrypt ]
Specifies value of x-header field to be inserted:
3gpp: 3GPP service.
apn: APN of the bearer flow. This field is deprecated from under bearer apn and has been added within bearer 3gpp apn.
charging-characteristics: Charging characteristics of the bearer flow.
charging-id: Charging ID of the bearer flow.
imei: IMEI or IMEISV (depending on the case) associated with the bearer flow.
imsi: Specific Mobile Station Identification number.
qos: EPC QoS associated with the bearer flow.
The inserted x-header is seen as:
x-bearer-qos: 020400000100000002000000010000000200\r\n
rat-type: This field is deprecated from under bearer rat-type and has been added within bearer 3gpp rat-type.
s-mcc-mnc: 3GPP serving node MCC + MNC associated with the bearer.
The inserted x-header is seen as:
x-s-mcc-mnc: 123765\r\n
sgsn-address: SGSN associated with the bearer flow.
acr: Anonymous Customer Reference. Only MSISDN part of this is encrypted, if encrypt flag is set.
customer-id: Customer ID of the bearer.
ggsn-address: GGSN IP address field.
imsi: This field is deprecated from within bearer imsi and has been moved within bearer 3gpp imsi.
mdn: MDN of the bearer flow.
msisdn-no-cc: MSISDN of the mobile handling the flow without the country code.
radius-calling-station-id: Calling Station ID of the mobile handling the flow.
session-id: Accounting session ID of the bearer flow.
sn-rulebase: Name of the ACS rulebase.
sgsn-address: This field is deprecated from under bearer sgsn-address and has been moved within bearer 3gpp sgsn-address.
subscriber-ip-address: Subscriber IP address.
username: User name of the bearer flow.
encrypt: Specifies encryption of x-header field configuration. This option must only be configured in the case of x-header encryption feature.
http { host | url }
Specifies value of the x-header field to be inserted:
host: Host
url: Uniform Resource Locator
Usage
Use this command to configure the x-header fields to be inserted in HTTP/WSP GET and POST request packets. The x-headers would be inserted at the end of HTTP/WSP header. This CLI command may be used up to 10 times. There is no control over the order of the fields that are to be inserted. Any of the indicated ruledef variables may be inserted using the variable option, or a static string may be inserted using the string-constant option.
Operators may insert x-headers in some HTTP/WSP packets, for which some rules will be configured. The charging-action associated with these rules will contain the list of x-headers to be inserted in the packets.
Example
The following command configures an x-header field named test12 with a constant string value of testing to be inserted in HTTP/WSP GET and POST request packets:
insert test12 string-constant testing
 
 

Cisco Systems Inc.
Tel: 408-526-4000
Fax: 408-527-0883